ngl: Set color as vertex attribute

Instead of using uniforms for color used in multiple
programs, pass it as vertex attributes. This will let
us batch more draw calls, since we don't have to change
uniforms so often. In particular, for syntax-highlighted
text.

gsk: Give ngl its own shader sources

We may want to change the interface between the
shaders and the renderer for ngl, and therefore,
sharing the shaders between gl and ngl will not
be practical, going forward.

Merge branch 'fix-3704' into 'master'

gdksurface-win32.c: Fix window menu positioning (issue #3704)

Closes #3704

See merge request GNOME/gtk!3286

gdksurface-win32.c: Fix window menu positioning

We ought to get the coordinates of where the window menu should be
displayed using gdk_win32_surface_get_root_coords(), instead of rounding
the position that we obtained with gdk_event_get_position().

Also rename items a bit in the same function, and call
gdk_event_get_event_type() for consistency with the other backends.

Fixes issue #3704.

Update Korean translation

(cherry picked from commit 7774d5d85e86f97d9ef7195c808bcd2d88ef49eb)

Merge branch 'bilelmoussaoui/shortcuts-annotation' into 'master'

g-i: fix gtk_shortcut_label_new annotation

See merge request GNOME/gtk!3285

g-i: fix gtk_shortcut_label_new annotation

Merge branch 'ebassi/gidocgen' into 'master'

Move API reference to gi-docgen

See merge request GNOME/gtk!3222

docs: Add URL maps for cross links

docs: Enable search

docs: Update the "running GTK apps" section

Style the content a bit better, and use the appropriate links.

Small updates to the coding and documentation style

Mention summary sentences, and a few other things.

build: Add missing variable definition

build: Add a GIR dependency to PangoCairo

This is not strictly needed from an introspection perspective, but:

 - GTK strictly depends on PangoCairo internally
 - we want to integrate the GDK docs with PangoCairo's

So even though we don't have an explicit dependency on PangoCairo types
in our ABI, we do assume that people will be able to use the PangoCairo
API with GTK.

Handle static inline GtkOrdering function

The introspection scanner does not handle `static inline` functions:
they are not in the shared library, so cannot be dlsym() out of it; and
the `static` keyword tells g-ir-scanner to skip the function declaration
entirely.

We can trick the scanner into thinking the gtk_ordering_from_cmpfunc()
symbol is a real, public one, by declaring and defining a regular
function under the `__GI_SCANNER__` guard; the symbol does not appear
when actually building GTK, or any code using GTK, so we don't risk
collisions.

docs: Show class hierarchy in the API references

label: Fix some external links

I had put in a bunch of [class@Pango.Attribute],
but it needs to be [struct@Pango.Attribute].

Know your dependencies` type hierarchy!

text: Fix some copy-paste mishap

A bunch of occurrances of "the self" looked like
absurdist short fiction:

"...the self scrolled off the screen to the left"

widget: Fix up some links

Fix up some links to vfuncs and to sections, as well as class methods.

shortcuttrigger: Convert docs

shortcutlabel: Convert docs

shortcutcontroller: Convert docs

shortcutaction: Convert docs

shortcut: Convert docs

sizegroup: Convert docs

testutils: Convert docs

snapshot: Convert docs

tooltip: Convert docs

settings: Convert docs

recentmanager: Convert docs

mountoperation: Convert docs

menutrackeritem: Remove SECTION

This is private

menutracker: Remove SECTION

This is private.

treesortable: Add a summary

treeselection: Add a summary

treemodelsort: Add a summary

treemodelfilter: Add a summary

treemodel: Add a summary

treednd: Add summaries

treestore: Add a summary

liststore: Add a summary

treeviewcolumn: Add a summary

treeview: Add a summary

windowgroup: Convert docs

listbox: Convert docs

iconview: Add a summary

constraintsolver: Remove SECTION

This is private

cellview: Add a summary

cellrenderertoggle: Add a summary

cellrenderertext: Add a summary

cellrendererspinner: Add a summary

cellrendererspin: Add a summary

cellrendererprogress: Add a summary

cellrendererpixbuf: Add a summary

celleditable: Add a summary

cellrenderercombo: Add a summary

cellrendereraccel: Add a summary

cellrenderer: Add a summary

celllayout: Add a summary

cellareacontext: Add a summary

cellareabox: Add a summary

cellarea: Add a summary

actionobserver: Drop SECTION

This is private.

actionobservable: Drop SECTION

This is private.

actionmuxer: Drop SECTION

This is private.

accessiblevalue: Drop SECTION

This is private.

cssdataurl: Drop SECTION

This is private

bloomfilter: Drop the SECTION

This is private, no need.

accelgroup: Convert docs

Drop an unused SECTION, and convert links.

scrollbar: Tweak docs

placesview: Remove SECTION

Its private, no need.

placessidebar: Remove SECTION

Its private, no need.

modelbutton: Remove SECTION

Its private, no need.

filechooserwidget: Convert docs

treelistmodel: Convert docs

treeexpander: Convert docs

shortcuttrigger: Tweak docs

selectionmodel: Convert docs

multiselection: Convert docs

listlistmodel: Remove SECTION

Private, no point.

noselection: Convert docs

selectionfiltermodel: Convert docs

immulticontext: Convert docs

imcontextsimple: Convert docs

gestureswipe: Convert docs

papersize: Convert docs

gesturestylus: Convert docs

imcontext: Convert docs

widgetpaintable: Convert docs

singleselection: Convert docs

slicelistmodel: Convert docs

gesturesingle: Convert docs

maplistmodel: Convert docs

scrollable: Tweak docs

overlaylayout: Add docs for GtkOverlayLayoutChild

gesturerotate: Convert docs

padcontroller: Convert docs

gesturezoom: Convert docs

mediafile: Convert docs

mediastream: Convert docs